home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / net / atcp_ttcp10.lha / ttcp.man < prev    next >
Text File  |  1993-10-10  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTCP(1)                  USER COMMANDS                    TTCP(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      ttcp - test TCP and UDP performance
  10.  
  11. SYNOPSIS
  12.      ttcp  -t   [-u]   [-s]   [-p _p_o_r_t]   [-l _b_u_f_l_e_n]   [-b _s_i_z_e]
  13.      [-n _n_u_m_b_u_f_s]  [-A _a_l_i_g_n]  [-O _o_f_f_s_e_t]  [-f _f_o_r_m_a_t] [-D] [-v]
  14.      host [<in]
  15.      ttcp -r [-u] [-s] [-p _p_o_r_t] [-l _b_u_f_l_e_n] [-b _s_i_z_e] [-A _a_l_i_g_n]
  16.      [-O _o_f_f_s_e_t] [-f _f_o_r_m_a_t] [-B] [-T] [-v] [>out]
  17.  
  18. DESCRIPTION
  19.      _T_t_c_p times the transmission and reception  of  data  between
  20.      two systems using the UDP or TCP protocols.  It differs from
  21.      common ``blast'' tests, which tend  to  measure  the  remote
  22.      _i_n_e_t_d  as much as the network performance, and which usually
  23.      do not allow  measurements  at  the  remote  end  of  a  UDP
  24.      transmission.
  25.  
  26.      For testing, the transmitter should be started with  -t  and
  27.      -s  after  the  receiver  has  been  started with -r and -s.
  28.      Tests lasting at least tens of seconds  should  be  used  to
  29.      obtain  accurate  measurements.   Graphical presentations of
  30.      throughput versus buffer size for buffers ranging from  tens
  31.      of bytes to several ``pages'' can illuminate bottlenecks.
  32.  
  33.      _T_t_c_p can also be used  as  a  ``network  pipe''  for  moving
  34.      directory  hierarchies between systems when routing problems
  35.      exist or when the use of other  mechanisms  is  undesirable.
  36.      For  example,  on the destination machine, use: ttcp -r -B |
  37.      tar xvpf -
  38.  
  39.      and on the source machine: tar cf  -  directory  |  ttcp  -t
  40.      dest_machine
  41.  
  42.      Additional intermediate machines can be included by: ttcp -r
  43.      | ttcp -t next_machine
  44.  
  45. OPTIONS
  46.      -t        Transmit mode.
  47.  
  48.      -r        Receive mode.
  49.  
  50.      -u        Use UDP instead of TCP.
  51.  
  52.      -s        If transmitting, source a data pattern to network;
  53.                if  receiving,  sink  (discard) the data.  Without
  54.                the -s option, the default  is  to  transmit  data
  55.                from _s_t_d_i_n or print the received data to _s_t_d_o_u_t.
  56.  
  57.      -l _l_e_n_g_t_h Length of buffers in bytes  (default  8192).   For
  58.                UDP,  this  value  is  the number of data bytes in
  59.                each packet.  The system limits  the  maximum  UDP
  60.  
  61.  
  62.  
  63. Sun Release 4.1        Last change: local                       1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTCP(1)                  USER COMMANDS                    TTCP(1)
  71.  
  72.  
  73.  
  74.                packet  length. This limit can be changed with the
  75.                -b option.
  76.  
  77.      -b _s_i_z_e   Set size of socket  buffer.   The  default  varies
  78.                from system to system.  This parameter affects the
  79.                maximum UDP packet length.  It may not be possible
  80.                to  set  this parameter on some systems (for exam-
  81.                ple, 4.2BSD).
  82.  
  83.      -n _n_u_m_b_u_f_s
  84.                Number  of  source  buffers  transmitted  (default
  85.                2048).
  86.  
  87.      -p _p_o_r_t   Port number to  send  to  or  listen  on  (default
  88.                2000).   On  some  systems, this port may be allo-
  89.                cated to another network daemon.
  90.  
  91.      -D        If transmitting using TCP, do not buffer data when
  92.                sending  (sets the TCP_NODELAY socket option).  It
  93.                may not be possible to set this parameter on  some
  94.                systems (for example, 4.2BSD).
  95.  
  96.      -B        When receiving  data,  output  only  full  blocks,
  97.                using the block size specified by -l.  This option
  98.                is useful  for  programs,  such  as  _t_a_r(1),  that
  99.                require complete blocks.
  100.  
  101.      -A _a_l_i_g_n  Align  the  start  of  buffers  to  this   modulus
  102.                (default 16384).
  103.  
  104.      -O _o_f_f_s_e_t Align the start of buffers to this offset (default
  105.                0).  For example, ``-A8192 -O1'' causes buffers to
  106.                start at the second byte of an 8192-byte page.
  107.  
  108.      -f _f_o_r_m_a_t Specify, using one of  the  following  characters,
  109.                the format of the throughput rates as kilobits/sec
  110.                ('k'), kilobytes/sec  ('K'),  megabits/sec  ('m'),
  111.                megabytes/sec   ('M'),   gigabits/sec   ('g'),  or
  112.                gigabytes/sec ('G').  The default is 'K'.
  113.  
  114.      -T        ``Touch'' the data as they are read  in  order  to
  115.                measure cache effects.
  116.  
  117.      -v        Verbose: print more statistics.
  118.  
  119.      -d        Debug: set the SO_DEBUG socket option.
  120.  
  121. SEE ALSO
  122.      ping(1M), traceroute(1M), netsnoop(1M)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1        Last change: local                       2
  130.  
  131.  
  132.  
  133.